Ê
 


HomePage:
    http://gallery.uunet.be/bwynants/mac/HandyMan.html

HandyMan 2.0.8 (2000-09-05) Copyright © 1995-2000 Bert Wynants


Table of Contents

	1.	Introducing HandyMan

	2.	System Requirements

	3.	Installing HandyMan

	4.	Using Modifier keys

	5.	Advanced Usage

	6.	Localization (Catalog files)

	7.	The Configuration menu

	8.	The Contextual menu

	9.	About the Program

	10.	About the Author

	11. Acknowledgements

	12.	Frequently Asked Questions

	13.	Tips And Tricks

	15.	Known problems


1.	Introducing HandyMan

HandyMan is a Control Strip Launching Module.

It is designed to allow quick and easy access to applications, Control Panels, Desk Accessories, Folders and other documents stored on your Macintosh, without having to navigate through several ÒFinder WindowsÓ or through a multi-layered, hierarchical Apple menu.

It works by clicking on icons installed in a floating window, or dropping documents onto them.  This approach is much handier than aliases that are on the desktop because the floating windows that contain the icons can never be covered by windows.  HandyMan also requires a lot less desktop space than the same number of icons on the desktop.

2.	System Requirements

HandyMan can run on any Macintosh model, and requires at least System 7.1 and Control Strip installed.

Make sure the ÒFinder Scripting ExtensionÓ version 1.2 is installed to work with Folder icons, Trash icons, Control Panel icons, and ordinary documents ...

If Drag Manager 1.1 is installed you can drag and drop documents on the applications, folders and Trash icons in the strip (Mac OS version 7.5 has the Drag Manager included).

For best functionality you need MacOS 9.0 with ÒControl StripÓ version 2.0 (or higher) installed, or with ÒExtensions StripÓ version 1.9 (or higher) installed.

Should you have any trouble running HandyMan on your machine, please write to me with the full specifications of your machine and what version of HandyMan you are using, as well as the name and version of the strip module you have installed.


3.	Installing HandyMan

1.	Install the Apple Control Strip control panel, or an alternative such as Extensions Strip. Control Strip is automatic installed if your system is recenter as MacOS 8.0.  If you use a desktop Mac, you must have at least version 1.3 of Apple's Control Strip (earlier versions only worked on portable Macs).  For increased functionality, use Extensions Strip.  

2. ÒHandyManÓ must be in the  ÒControl Strip ModulesÓ folder. Just Drop it onto the System Folder and the system will put it, after confirmation, automatically into the ÒControl Strip ModulesÓ folder. It may be named differently on non-English systems.

3. The ÒHandyMan GuideÓ must be in the ÒExtensionsÓ Folder. Just drop it onto the System Folder and the system will put it, after confirmation, automatically into the ÒExtensionsÓ folder. By putting it into that folder you can get help in the finder under the Help Menu. If you don't need that you can drop it in the same folder as where HandyMan is. This way you can access help via the HandyMan configuration Menu.

4.	Restart your Macintosh to activate HandyMan.  This restart is not needed for Extensions Strip users or MacOS 8.5 (or later) users.

5.	Configure HandyMan by dropping aliases into the ÒHandyMan AliasesÓ folder, or by dropping files onto the Ò+Ó icon at the start of each column/row. Or drop a file between 2 existing ones.  If you click on the Ò+Ó icon in your strip, it will open the ÒHandyMan AliasesÓ folder (or the folder for that column/row if you are using Extensions Strip).  Removing icons is done by dragging them to the Trash or by selecting ÒDelete IconÓ from the Icon Menu.  Control Strip should update to Control Strip 2.0 which is part of MacOS 8.5 (see Known problem 2).

6.	If you are using Extensions Strip, you can have multiple floating windows.  All you need to do is have multiple folders inside your Control Strip Modules folder in your System folder.  There will be one floating window on your screen for each folder you create.  For a typical setup, you would have one folder containing controls that you would typically put into Apple's Control Strip.  A second folder would contain the Process Manager module that is distributed with Extensions Strip.  A third or fourth (or fifth) could each contain a copie of HandyMan set up in different ways.  A single strip containing an alias of the Trash will always float above other windows, so you can always find the Trash.


4.	Using Modifier keys

There are a few simple modifier keys that can be used:

Text Labels:
  clicking on a text label allows you to resize the labels by dragging them Left or Right.
 Shift selecting ÒShow TextLabelsÓ from the preference menu puts the labels under the icons.
 Option () selecting ÒShow TextLabelsÓ from the preference menu shows only the Labels.

Trash:
 Option () click on the Trash will empty it.

Folders:
 Option () drop on a folder copies the files to that folder, otherwise they will be moved.
  clicking on a folder icon filters out non-folder items from that popup menu.
 Shift clicking on a folder icon filters out folders from that popup menu.
  dropping on a folder will force the copy or move to happen (no dialog popping up if the file already exists).
  key wil force finder info for selection of folder menu item.

Clippings: 
 Shift clicking on a clipping copies it to the clip-board.
 Shift selecting it from a popup menu copies the content to the clip-board.

Configuration:
 Option () dropping onto a Ò+Ó icon moves the file into the folder, instead of creating an alias of it.


5.	Advanced Usage
Use compiled Apple Scripts, onto which you can drag and drop just like onto an application, to add custom commands to the strip.  
sample usage:

	on run
		-- User has clicked the script to run it....
	end run

	on open theList
		-- User has dropped files onto script to open them....
			repeat with x in theList
				-- walk through the list of dropped items
			end repeat
	end open


6.	Localization (Catalog files)

For Localization HandyMan has support for catalog files.  If HandyMan can find a file HandyMan.Catalog in it's folder or in the preference folder it will use it for translating everything into the language described in that catalog file (Finder Info shows language and version number of the catalog file).

If your HandyMan does not get translated you should check that both HandyMan and the Catalog have the same version number.

Note: Localization can mean the ÔRecent DocumentsÕ folder is renamed to match that of the localized system.  If you can't get ÔRecent DocumentsÕ to work please see the ReadMe in the catalog folder of your active catalog (See also  Enable Items Popup  in The Configuration menu).

Check http://gallery.uunet.be/bwynants/mac/HandyMan.html for newer or updated catalogs.


7.	The Configuration menu

Small icon size
This option is only available in Extensions Strip!
This displays small icons, that take up a lot less space on your desktop Ð a real space saver.  If you would like mini sized icons, send me a letter with your comments.

Large icon size
This option is only available in Extensions Strip!
These icons are the same size as normal desktop icons, but they can be a lot closer together.  If you would like mini sized icons, send me a letter with your comments.

Show Popup Triangle
HandyMan has the ability to hide the configuration triangle to save some space on your desktop (or because it's neater without that triangle).
You can always use Control click on the module to make it show its configuration menu and change the settings.

Show Vertical icon list
This option is only available in Extensions Strip!
The list of icons can be arranged horizontally or vertically.

Show Multiple Rows/Columns
This option is only available in Extensions Strip!
In the Configuration menu you will see either ÒShow Multiple RowsÓ or ÒShow Multiple ColumnsÓ.  The option displayed depends on how you have set the ÒShow Vertical icon listÓ option in the Configuration menu.  To make multiple columns you can put a number of folders in the ÒHandyMan AliasesÓ folder and select the ÒShow Multiple Rows/ColumnsÓ option.  This way folders are parsed one level deep, folders in those folders don't show up as additional rows/columns but as folders icons in the bar (for more information see the sample pictures included in the Examples document). 
Ê

To completly suppress the adding of a folder make the first character of its name a ÔÂÕ (Option()-L) (e.g. ÓÂDisabled ItemsÓ).

Since HandyMan 1.4 you can select the "Add Row" or "Add Column" menuitem for easier creation of multiple rows/columns (see ÒAdd Row/ColumnÓ).

Show InfoBar
This option is only available in Extensions Strip!
Let HandyMan tell you what item the mouse is over.

Ê

Show PopInfo 
Text showing the name of the icon under the mouse pops up when you keep the pointer steady over a HandyMan icon for a few moments.  The text always pops up inside the strip module's bounds.  This method requires less screen space than the InfoBar, and works with Apple's Control Strip. 

Ê

Show TextLabels
Icons are shown with the name next to them. 
Option () selecting this menu item removes the icon and only a text label will be shown.  To resize the text labels, click in them with the  key pressed.  A vertical line will appear that can be dragged to the left or right.

Ê


Extensions Strip users can Shift select this menu item to put the text label under the icon.

Show Entry Tiles
This option is only available in Extensions Strip!
Entries are shown with a small 3D frame. (Including the text labels)
This option is only for nicer drawing and has for the rest no effect whatsoever...

Ê


Show Icon Tiles
This option is only available in Extensions Strip!
Icons are shown with a small 3D frame and the Icons behave like buttons.
(Clicking anyware in the Icon selects the Icon.)

Ê


Show Aliases Folder
A "+" icon is added to the start of the strip onto which you can drop icons to add them to the strip.  With a normal drop, an alias is created, then put in the configuration folder.  If you hold the Option () key down while you drop the icon, the item is moved to that location.  If an icon drag is started on the strip, by default, the alias is moved to the new row.  The Option () key changes this into a copy.  To remove an icon, drag it to the Trash.  If you are not using Extensions Strip, then read Known problem 2.

Ê

Resolve Dragged Alias
This only applies to installed applications.  It is a toggle for applications to open the alias or the document the alias refers to.

Enable Items Popup
Enable this option then click and hold On an item in HandyMan a context sensitive menu will show up. Some available commands are Launch, Bring to front, Show Original, Finder Info and Delete Icon.

On a folder HandyMan additionally lets you select a file that is in that folder.  

On applications HandyMan will list all items from the Favorites folder that can be handled by the application, next it will add all items from the Recent Documents folder that can be handled by the application.

To enable the Recent Documents folder you have to use the ÔApple Menu OptionsÕ control panel and put a number in the ÔDocumentsÕ option from ÔRemember recently used itemsÕ 

You can also make the ÔRecent DocumentsÕ folder yourself and put it in the ÔApple Menu ItemsÕ folder or into the System folder.  If you put some aliases to documents in it.  The documents will popup on applications if you click and hold the mouse for a few moments over an application. 

You also can lock or label aliases in that those folders to make it easier to spot them in HandyMan (See also Known problem 1).

TIP: If you use a localized version of the ÔApple Menu OptionsÕ control panel and you don't have a Catalog for HandyMan in that language you can make an alias to your localized ÔRecent DocumentsÕ folder and that alias has to be put into the System folder with the name ÔRecent DocumentsÕ (or the name described in the active catalog).  If HandyMan doesn't find the ÔRecent DocumentsÕ in the ÔApple Menu ItemsÕ folder it will try to find it in the System folder and will resolve your alias to the correct folder.

Enable Drag Away
This requires ÒMacintosh Drag and DropÓ version 1.1 or higher to be installed.
This option must be on before you can drag items from the strip.  Then you can drag them to the Trash or desktop to remove them from the strip.  This is handy if you have an alias installed for the ÔFind OriginalÕ script from Apple.  You can drag items from HandyMan to this script, and the script will show you where the original file is located.  If you are not using Extensions Strip or Control Strip 2.0 (part of MacOS 8.5), then read Known problem 2.

Use Alfabetic Sorting
Items in the strip are sorted alfabeticaly, prior to HandyMan 2.0 this was the only way.
If this option is off sorting is based on the position of the Icons in the Finder Windows. HandyMan will organize your icons if you drop at a certain locations.
For this to work correct one must keep the HanyMan Folders closed in the finder.

Add Row/Column
In the Configuration menu you will see either ÒAdd RowÓ or ÒAdd ColumnÓ.  The option displayed depends on how you have set the ÒShow Vertical icon listÓ option in the Configuration menu.  If it is not possible (ÒShow Multiple Rows/ColumnsÓ and ÒShow Aliases FolderÓ must be checked), this option will be greyed out.

Update icon list
Will re-parse your configuration folder and update all links.

About HandyMan
Guess what...

Help
Brings up help via AppleGuide...

RegisterÉ
Only visible in an unregistered version.
Pops up a dialog box requesting your serial number. See the ÒRegistration InformationÓ file for more info about how to register.

8.	The Contextual menu

As of HandyMan 2.0 every item in the strip has a contextual menu. Click and hold on an entry to get it.

Launch/Open
same as just clicking on the entry.

Delete Icon
removes the icon from the strip.

Show Original
Shows the original icon in the finder
Holding down Option () while selecting this will show you the alias in the HandyMan Folder.

Finder Info
Shows the ÔGet InfoÉÕ window of the original item.
Holding down Option () while selecting this will show ÔGet InfoÉÕ for the alias in the HandyMan Folder.

Empty Trash
Empties your trash.

9.	About the Program

HandyMan is © by 1995-2000 Bert Wynants.

HandyMan is shareware. Check out the ÒHow to RegisterÓ to see how you can register.

HandyMan has proven to be stable in everyday use.  The author is not responsible for any loss of data, damages to software or hardware that may result directly or indirectly from the use of this program.  The author reserves the right to make changes to the software or documentation without notice.

None of the files of the HandyMan package may be modified.  Crunching or archiving is allowed only if none of the HandyMan files get modified by it.

10.	About the Author

Bugs, questions, or suggestions to:

Internet e-mail
    bwynants@kagi.com

HomePage:
    http://gallery.uunet.be/bwynants/

11.	Acknowledgements

¥ Aaron D. Ruiz, Aron S. Spencer, Boris Klug, Brian Renken, Kees Van Wijk, Christopher Li, David D. Kilzer, Drew Wade, Hans Verhoeven, Harry Ehrlich, Jan Dockx, Jeremy Keens, Karl Allison, Mason Loring Bliss, Michael Kisor, Michele Pizzi, Panos Philippakopoulos, Patrick Merel, Peter Frings, Steve Russillo, Steve Levinson and Wesley Summers for beta testing.

¥ Wesley Summers for reworking and correcting the readme, history and examples text files!

¥ Ammon Skidmore for all the help and for Extensions Strip.

¥ Hisashi Nishimura and Michele Pizzi for all the work on the translated Readmes.

¥ Christopher Li, Kuzu Otsuka, Boris Klug, Michele Pizzi, Panos Philippakopoulos, Markus Gloede, Gjermund Gusland Thorsen, HŒkan Liljegren, Igor Zakharov, Fredrik Chr. Bolin, Ralph Witteveen and Rene Molsted for the Catalog Translations.

¥ All those who have sent me a postcard!

12.	Frequently Asked Questions (FAQs)

Q.1:	Why doesn't drag and drop work?
A.1:	Your system does not have the Macintosh Drag and Drop 1.1 extension, or your Finder isn't drag and drop aware.  You should upgrade to at least Finder version 7.1.2 for the PowerMac or 7.1.3 for 68k Macs.  Finder 7.1.3 comes with System 7 Pro, and Finder 7.1.4 comes with Mac OS version 7.5.  If you do not have the correct software, you will not be able to drag Finder icons onto other icons.  If you try, the icons will not highlight when you drag over them, and nothing will happen when you drop something on an icon.  You can get Mac Drag & Drop 1.1 via anonymous ftp at ftp.support.apple.com/pub/Apple SW Updates/US/mac/System Software/Other System Software/.

Q.2:	Do I (really) need the scriptable Finder?
A.2:	No, but if your system lacks the Scriptable Finder, some varieties of icons will not work.  In fact, they usually won't be added to the strip.  Folder icons, Trash icons, Control Panel icons, and ordinary documents require the Scriptable Finder in order to be fully operational.  The Finder Scripting extension 1.2 comes with Mac OS version 7.5, or you can get it via anonymous ftp at ftp.support.apple.com/pub/Apple SW Updates/US/mac/System Software/Other System Software/.

Q.3:	You seem to indicate in the ReadMe file supplied with HandyMan that it is possible to have a number of folders (1,2 etc), in the Control Strip Module folder, with individual copies of HandyMan and HandyMan Aliases folders.
A.3:	Yes this is possible.  And each copy of HandyMan will run on it's own floating Window with it's own preferences.  However you need to have Extensions Strip for this to work.  See the Tips And Tricks section for more information.

Q.4:	I noticed that my hard disks keep spinning a very long time just after (or during) startup.  This does not happen if I de-install HandyMan.  It doesn't seem to be that severe on a Power Mac 7100/66av where I also tested it.  Is this known? Is there any remedy?
A.4:	After startup, Handyman uses an idle time mechanism to get some more information about your installed applications.  It goes out looking at what file types an application can open, so only drops of that kind are accepted.  It uses the translation manager to do so, and if the Translation manager is not available, it uses a fall-back method.  However this fall-back is not as fast as the Translation manager, so make sure Macintosh Easy Open is installed.  

Q.5:	Why can't I select ÒAdd Row/ColumnÓ from the Configuration menu?
A.5:	Be sure you have selected ÒShow Multiple Rows/ColumnsÓ and ÒShow Aliases FolderÓ from the Configuration menu.


13.	Tips And Tricks

¥	1.  If the Option () key conflicts with Control/Extensions Strip, press the mouse button first, then press the Option () key.

¥	2.  To differentiate between folders, you can give them a label color in the Finder.  Give folders that have the same icon a different label color in the Finder.  HandyMan will display the icon in the same manner as the Finder after the icon display is updated.  Select ÒUpdate icon listÓ from the Configuration menu to update your HandyMan display immediately.

¥	3.  As long as there are generic icons for documents or applications, HandyMan watches Disk Inserts and tries to get the icons from the desktop database of the inserted disks.  If you have applications or documents that really have a generic icon you should paste a custom icon onto them to stop HandyMan scanning inserted disks (although it won't hurt watching the Disks).

¥	4.  Put a HandyMan floating strip over your Trash, containing only a Trash, and configure it to show large icons.  No more digging to find your Trash!

¥	5.  To quickly spot a frequently accessed recent file, make it locked in the ÔRecent DocumentsÕ folder, HandyMan will underline it in the popup menu.  Also see Known problem 2.

¥	6.  If HandyMan tells you it is unable to resolve an alias, you can try to do ÔFind OriginalÕ in the Finder Info window for that alias.  This often fixes the problem.

¥	7.  Add the example Separator to the strip.  This entry won't be clickable but gives you a nice separation bar.  To position it, just give it a name that sorts between the two icons you want to separate or move it to the appropriate place when Alfabetic Sorting is off.


14.	Known problems

1.	Never put locked aliases into the ÔRecent files/folders/serversÕ folders from ÔApple Menu OptionsÕ with versions prior to Mac OS version 7.5.3.  It will crash your system! Not a HandyMan issue but a nasty one.

2.	Dragging an icon from HandyMan on a drag-able window of the current application or over the desktop when the Finder is in front fails (Drag Manager bug).  I didn't remove the ÒEnable Drag AwayÓ option because dragging an icon from handyman works very well if you stay in the strip, and can be useful to drop it onto one of the handyman icons (e.g.  the Trash) or to reorder items.  Due to this problem, dragging should currently be confined to within the strip module.  This problem does not occur when using Extensions Strip or Control Strip 2.0 (part of MacOS 8.5).

3.  If Alfabetic sorting is off, you have to close the ÒHandyMan AliasesÓ windows in the finder and it's subfolders or it won't work correct.
